home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 013 / xd100.arc / XD.DOC < prev   
Encoding:
Text File  |  1987-01-02  |  7.1 KB  |  170 lines
  1.  
  2.  
  3.    XD (eXtended Directory/eXchange Directory) by Bob Abrahams.
  4.                           January, 1987
  5.  
  6. This program is released to the public domain and may be used and 
  7. distributed without restriction provided that the program and 
  8. its associated documentation files are not sold.  In using this 
  9. program, the user agrees that the author is not liable for 
  10. problems arising in the use of the program, whether in 
  11. the operation of the program itself or its affect on other 
  12. programs or operation of the computer system.
  13.  
  14. ---------------------------------------
  15.  
  16. XD (eXtended Directory change) COMMAND
  17.  
  18. Purpose:  Provides for extended Change Directory capability, 
  19.           including ability to exchange between two directories 
  20.           without specifying path each time, changing to parent 
  21.           directory without specifying entire path and defining 
  22.           and changing to directories in an abbreviated manner.
  23.  
  24. Format:   [d:][path]XD [d:][path] | / | * | ?
  25.  
  26. Type:     Internal  External
  27.                       ***
  28.  
  29. Remarks:  Specify the parameters:
  30.           
  31.           [d:][path] before XD to specify the drive and path that 
  32.           contains the XD command file.
  33.  
  34.           [d:] to specify the drive specifier of the disk whose 
  35.           current directory you want to change or display.
  36.  
  37.           [path] to specify the desired directory path name.  The 
  38.           path name cannot be more than 63 characters starting 
  39.           from the root directory.
  40.  
  41.           NOTE:  Unlike the DOS CD command, XD actually changes 
  42.           the default logged drive to the drive given, if any.
  43.  
  44.           See notes below regarding the use of /, * and ?.
  45.  
  46.  
  47. COMMAND FORMS:
  48.  
  49.      In the description below, <directory> indicates a directory 
  50. definition.  If a drive is not included, the default logged drive 
  51. is assumed.  If the path does not start at the root (i.e. if it 
  52. does not start with \), the current directory on the drive 
  53. indicated preceeds the path given.
  54.  
  55.      The "current directory" refers to the drive and directory 
  56. active when the program was started.
  57.  
  58.      XD <directory>
  59.      Saves current directory and changes to indicated 
  60. directory.  If the indicated directory is the same as the one 
  61. last saved, the last different directory remains in memory.
  62.  
  63.      XD
  64.      Exchanges current directory and last saved directory.  If 
  65. the saved directory was on a different drive, the logged drive is 
  66. also changed accordingly.  This may be repeated, exchanging back 
  67. and forth between two directories.  If XD has not been 
  68. initialized by previous use, nothing is saved, and an error 
  69. message is displayed.
  70.  
  71.      XD /
  72.      Saves current directory and changes to parent of current 
  73. directory.  (If at root directory, no change is made in directory 
  74. or in saved directory.)
  75.  
  76.      XD *
  77.      Saves current directory.  May be used to initialize the XD 
  78. resident memory section.  Standard output messages are supressed.  
  79. Not required under normal XD usage.
  80.  
  81.      XD ?
  82.      Displays help screen.
  83.  
  84.  
  85. ERROR MESSAGES:
  86.  
  87.   Invalid directory
  88.      This error will occur if the directory specified cannot be 
  89. found.  Possible causes include not being on the drive with the 
  90. directory requested, not starting from the root (starting with \) 
  91. when this is appropriate and incorrectly entering the 
  92. parameter string.  This can also occur using the XD command to 
  93. exchange to the last saved directory if this directory had been 
  94. removed since it was saved.  When this error occurs, the 
  95. directory is not changed and the saved directory is not changed.
  96.  
  97.   No directory saved
  98.      This occurs when the XD command (without parameters) is used 
  99. when the resident memory portion of XD has not been initialized.  
  100. XD will automatically initialize itself the first time a 
  101. successful change is made using the XD [directory] command or the 
  102. XD / command, or manually, by using the XD * command.  This error 
  103. also causes display of the date and version number and prompts 
  104. the user to use the XD ? (help) command.
  105.  
  106.  
  107. NOTES:
  108.  
  109.      A space is required following the program name (XD) before 
  110. the other parameters, even if the string starts with a backslash.  
  111. This is unlike the built-in command CD which does recognize the 
  112. backslash as the start of the directory name.  Example:  In DOS 
  113. you can enter CD\ to change to the root directory, but with XD, 
  114. you must enter XD \, NOT XD\.  This is a limitation built in to 
  115. the COMMAND.COM command parser. 
  116.  
  117.      To display the version and release date, use the XD ? 
  118. command or TYPE the XD.COM file.
  119.  
  120.      XD saves a small amount of resident memory to save the last 
  121. directory.  This happens only the first time that XD is used 
  122. where it can successfully save the directory, unless removed by a 
  123. reboot or by a resident memory utility.  Thereafter the same 
  124. memory space is reused.  XD should operate properly in most MS-
  125. DOS and PC-DOS environments (v. 2.0 and later), used before or 
  126. after other resident programs.  
  127.  
  128. However, XD should not be first invoked within a shell or 
  129. secondary COMMAND, as the memory space reserved will confuse the 
  130. DOS memory allocation system when the user returns to the higher 
  131. shell level.  This also applies to using XD using the R command 
  132. in WordStar or other similar applications.  This may be easily 
  133. handled by issuing an XD * command while at the highest level and 
  134. can be insured by including an XD * command in the AUTOEXEC.BAT 
  135. file.  This makes no directory changes but does initialize the XD 
  136. memory space.  This is not necessary under most circumstances.
  137.  
  138.      XD displays the drive/directory in effect at the end of the 
  139. program.  It also indicates whether the directory was changed or 
  140. whether there was no change.  (There would be no change in case 
  141. of an error, which will be indicated, or if the attempt is made 
  142. to change to the same directory in effect when the program 
  143. started.)  This message line is suppressed for the XD * command.  
  144. It can also be suppressed by patching the byte at location 0108h 
  145. in the XD.COM file to 0.  This may be useful if the PROMPT 
  146. command has been used to display the drive and directory.  See 
  147. below for more patching information.
  148.  
  149.      XD provides for certain patchable parameters within the 
  150. program XD.COM.  These can be changed to customize the program 
  151. somewhat.  At the start of the XD.COM file, following a 3-byte 
  152. JMP instruction, there is a string of bytes that can be changed.  
  153. The location of each and their normal value and function are 
  154. described in the following table.  Use DEBUG or other patcher to 
  155. make the changes desired.
  156.  
  157.     Address   Normal      Function 
  158.      (hex)    value             and notes
  159.  
  160.   0100-0102  JMP START   DO NOT CHANGE.
  161.  
  162.      0103      12h       Interrupt number.  DO NOT CHANGE.
  163.      0104       0        Function number.  (Future parameter.)
  164.      0105      '/'       "Parent directory" character.
  165.      0106      '*'       "Current directory" character.
  166.      0107      '?'       "Help" character.
  167.      0108      0FFh      Non-zero to show directory 
  168.                               before exiting.
  169.  
  170.